From 07d71cf9455ff1afad242e47caf9d1dfffa4925a Mon Sep 17 00:00:00 2001
From: Matthias Clasen <mclasen@redhat.com>
Date: Sat, 16 Nov 2013 15:00:16 -0500
Subject: [PATCH] Small doc improvements

---
 gtk/gtkapplicationwindow.c | 4 +++-
 gtk/gtkheaderbar.c         | 3 ++-
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/gtk/gtkapplicationwindow.c b/gtk/gtkapplicationwindow.c
index 079f4bbdb2..caee9b1c6e 100644
--- a/gtk/gtkapplicationwindow.c
+++ b/gtk/gtkapplicationwindow.c
@@ -82,7 +82,9 @@
  * looks on different platforms).
  * This behaviour can be overridden with the #GtkApplicationWindow:show-menubar
  * property. If the desktop environment does not display the application
- * menu, then it will automatically be included in the menubar.
+ * menu, then it will automatically be included in the menubar. It can
+ * also be shown as part of client-side window decorations, e.g. by
+ * using gtk_header_bar_set_show_fallback_app_menu().
  *
  * <example><title>A GtkApplicationWindow with a menubar</title>
  * <programlisting><![CDATA[
diff --git a/gtk/gtkheaderbar.c b/gtk/gtkheaderbar.c
index 24be7290eb..a22b95c193 100644
--- a/gtk/gtkheaderbar.c
+++ b/gtk/gtkheaderbar.c
@@ -1908,7 +1908,8 @@ gtk_header_bar_get_show_fallback_app_menu (GtkHeaderBar *bar)
  * @setting: %TRUE to enable the fallback application menu
  *
  * Sets whether this header bar may show a menu button
- * for the application menu when needed.
+ * for the application menu when it is not shown by the
+ * desktop environment.
  *
  * Since: 3.12
  */
-- 
2.30.2